home *** CD-ROM | disk | FTP | other *** search
/ MacFormat 1997 February / macformat-047.iso / Shareware Plus / Utilities / Rainbow Demo v1.3a / Read Me First < prev    next >
Encoding:
Text File  |  1996-09-10  |  9.3 KB  |  271 lines  |  [ttro/ttxt]

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18. New features in version 1.3 include:-
  19.  
  20.  
  21.   • 100% CPU speed capping option
  22.  
  23.   • Improved 5200 emulation of analogue controllers
  24.  
  25.   • Automatic high speed virtual disk access
  26.  
  27.   • Recognises ATR disk images intelligently
  28.  
  29.   • Preferences settings
  30.  
  31.  
  32.  
  33. Demo version 1.3
  34. ----------------
  35.  
  36.  
  37. Welcome to the world of Rainbow!
  38.  
  39. Now you can run many of your favourite Atari 8 bit software on your Mac.
  40.  
  41. Here's a quick list of key features in the full shareware version.
  42.  
  43.  
  44.   • Emulates 400/800, 800XL, 130XE and 5200 machines
  45.  
  46.   • Has 48K RAM for 400/800 machines; full 64K RAM for 800XL; full 128K for 130XE
  47.  
  48.   • Fast full and medium screen displays
  49.  
  50.   • Accepts 8K and 16K cartridge images; accepts 16K and 32K ROMs for 5200
  51.  
  52.   • Also runs Super Cartridges
  53.  
  54.   • True 256 Atari colours
  55.  
  56.   • Full ANTIC/GTIA graphics, namely all ANTIC modes, Player/Missile
  57.     Graphics, fine scrolling and Display List Interrupts
  58.  
  59.   • Two virtual disk drives capable of reading single and enhanced
  60.     density images
  61.  
  62.   • Transfer files between disk images and your Mac hard disk
  63.  
  64.   • Sound with 4 channels of pure tones and improvised noise
  65.  
  66.   • Four joysticks (via keypad) and four paddles (using mouse)
  67.   
  68.   • Plays many games such as PacMan, Defender, Joust, Qix, Eastern Front,
  69.     Zaxxon, M.U.L.E., Montezuma's Revenge, Donkey Kong, Miner 2049er, 
  70.     Necromancer, Karateka, Drol, Kaboom, Pole Position, Star Raiders, 
  71.     BallBlazer, Alternate Reality, Caverns of Mars, etc.
  72.  
  73.  
  74. The demo has the full graphics emulation of the shareware version except for vertical fine scrolling. Other features such as sound, larger screen displays and full 800XL/130XE emulation are not active in this demo.
  75.  
  76.  
  77.  
  78. System requirements
  79. -------------------
  80.  
  81. Two versions of Rainbow are provided; one for the PowerMac and one for 680x0 computers. It goes without saying that the PowerMac version is much faster and much more fun! However, faster '040 machines (33 Mhz+) also run at quite reasonable speeds. You should also have System 7 or later installed with Sound Manager 3.1 if you have a PowerMac.
  82.  
  83.  
  84.  
  85. What's inside?
  86. --------------
  87.  
  88. Inside the Rainbow folder, there should be the following items:-
  89.  
  90.  
  91.   • Rainbow Demo applications (one for PPC and another for 680x0 machines)
  92.  
  93.   • Disk image containing 3 demos (Bounce, Robot and Swan)
  94.  
  95.   • Read Me First text file (this one)
  96.  
  97.   • Appendices text file
  98.  
  99.   • Registration text file
  100.  
  101.   • Unhex folder with the Unhex application
  102.  
  103.  
  104.  
  105.  
  106. Atari ROM needed
  107. ----------------
  108.  
  109. IMPORTANT: Before you can run Rainbow you will need an image of one of the following:-
  110.  
  111.   • 400/800 10K Operating System ROM or
  112.  
  113.   • 800XL/130XE 16K Operating System ROM and 8K BASIC ROM or
  114.  
  115.   • 5200 2K monitor ROM.
  116.  
  117.  
  118. Due to copyright restrictions, Atari ROM images are not included and you will have to transfer the ROM from your 8 bit machine to the Mac via an 850 Interface Module. See the 'Appendices' text file for details.
  119.  
  120.  
  121.  
  122. Let's go!
  123. ---------
  124.  
  125. If you have the 400/800 10K OS ROM file on your Mac, rename it as OP_SYSTEM.
  126.  
  127. If you have the 800XL/130XE 16K OS ROM file on your Mac, rename it as OP_SYSXL and the 8K BASIC ROM file as OP_BASIC.
  128.  
  129. If you have the 5200 2K monitor ROM file on your Mac, rename it as OP_5200.
  130.  
  131. Put these file(s) in the same folder as Rainbow. 
  132.  
  133. Set your monitor to 256 colours.
  134.  
  135. Now launch Rainbow :^)
  136.  
  137. Rainbow looks for OP_SYSTEM first. If it's there, Rainbow enters 400/800 emulation mode. Otherwise it looks for OP_SYSXL. If it's there, 800XL (limited) mode is entered. Finally it will look for OP_5200 and if found, Rainbow impersonates the 5200 games console.
  138.  
  139. If you have more than one set of OS files, choose the emulation mode under the 'System' menu.
  140.  
  141. N.B. On this demo, 800XL emulation is 'limited', i.e. the 16K RAM under the ROM cannot be activated. This is also true for the 130XE mode which also has the extra 64K inactive. The full shareware version gives you complete 800XL and 130XE emulation.
  142.  
  143.  
  144.  
  145. Try out the demos!
  146. ------------------
  147.  
  148. Insert the demo disk and re-boot (select 'Yes...' under 'Re-boot' menu), which is like switching your Atari off and on again. The mouse pointer changes into an orange Atari fuji logo which indicates that drive#1 is being accessed.
  149.  
  150. N.B. In 800XL/130XE mode be sure to keep 'OPTION' pressed on re-booting to disable the BASIC ROM else the demos may not run properly (see 'Keyboard' below).
  151.  
  152. This disk will present you with a menu of 3 demos to try out. Bounce and Robot have some nice music and sound effects which, sadly, you can't hear on the demo of Rainbow. 
  153.  
  154. Check the 'Show FPS' item under the 'Extras' menu. This will give you real-time statistics on how well Rainbow is performing on your Mac. Adjust the frame rate in the 'TV' menu so that the CPU efficiency is just above 100%, i.e. normal 8bit speed. The 'fps' figure gives you the number of frames being generated every second. You can also force Rainbow to run no faster than 100%
  155. if you have the '100% Speed' item checked (leave it off for maximum speed!).
  156.  
  157. After you've finished playing with the demos, select 'Re-Init' under the 'Re-boot' menu. This removes all cartridges and disks from the drives and boots up as though you'd just launched Rainbow.
  158.  
  159.  
  160.  
  161. BASIC and DOS
  162. -------------
  163.  
  164. If you're in 400/800 mode, try inserting a cartridge (under the 'System' menu), e.g. BASIC if you have the file. If successful, the system will automatically re-boot and present you with the READY prompt.
  165.  
  166. Say you want to now boot up BASIC with DOS. Insert a disk image with DOS into drive#1. Rainbow will recognise standard images as well as ATR ones in either single or enhanced densities (standard images are carbon copies of the floppy disk image; an ATR image is a standard image with a 16 byte header).  
  167.  
  168. Now simply re-boot. 
  169.  
  170. After a few moments, you will be back in the BASIC but this time DOS is present. To check, just type DOS and you will go into the DOS utility menu.
  171.  
  172. N.B. A quicker way to start up in BASIC with DOS booted is to first insert the disk image and then insert the cartridge. 
  173.  
  174.  
  175.  
  176. Frame rate
  177. ----------
  178.  
  179. A real Atari 8-bit computer generates the playfield, player/missile graphics and updates Player/Missile collision registers every 60th of a second.
  180.  
  181. To make Rainbow run at an acceptable speed, you can alter the frequency with which this takes place under the 'TV' menu.
  182.  
  183. With the lesser frame rates, collision registers are updated less frequently and so occasionally your PacMan may pass through a ghost with no ill effect! Increase the frame rate to avoid this. 
  184.  
  185. Some games like Jumpman, Caverns of Mars and Buried Bucks only work with the 'Every' frame rate setting.
  186.  
  187.  
  188.  
  189. Disk drive
  190. ----------
  191.  
  192. Disk drive#1 is available to load single density images. Single density images have 720 sectors at 128 bytes per sector ==> 92160 bytes in total. ATR images have a 16 byte header, i.e. 92176 bytes.
  193.  
  194. The full shareware version gives you 2 disk drives each capable of single and enhanced densities together with a feature to save images.
  195.  
  196.  
  197.  
  198. Keyboard
  199. --------
  200.  
  201. In addition to the standard keyboard, some other important keys are
  202.  
  203.  System Reset = SHIFT  * (on keypad)  or F12  or cmd 0
  204.  Option       = SHIFT  'num lock'     or F1   or cmd 1
  205.  Select       = SHIFT  = (on keypad)  or F2   or cmd 2
  206.  Start        = SHIFT  / (on keypad)  or F3   or cmd 3
  207.  
  208.  Help         = - (on keypad)  or F4  or cmd 4     (XL only)
  209.  Pause        = - (on keypad)  or F4  or cmd 4  (5200 only)
  210.  
  211.  
  212.  Break        = SHIFT  esc
  213.  
  214.  Caps/Lowr    = alt  
  215.  
  216.  Atari Logo   = . (on keypad)  or ~
  217.  
  218.  
  219. The Mac CAPS LOCK is not functional. A number of extra editing keys are included,
  220. i.e. the cursor keys work and
  221.  
  222.  Insert Char  = ins/help
  223.  Delete Char  = del
  224.  Clr screen   = home / diag arrow pointing north-west.
  225.  
  226.  
  227.  
  228. Joystick
  229. --------
  230.  
  231. Stick 0 (Player 1) is enabled. Use the keypad for this (UP=8;LEFT=4;RIGHT=6;DOWN=5) and FIRE is Control or 0 on keypad.
  232.  
  233. Powerbook users can use the L<>? keys for the joystick by checking this item under the 'Joy' menu. These keys are then NOT recognised as keystrokes. Uncheck the L<>? item to use these as keystrokes.
  234.  
  235.  
  236.  
  237. 5200 emulation
  238. --------------
  239.  
  240. The 5200 is a curious machine with more or less the same hardware as a 400/800 computer. It has only 16K RAM but can accept 16 or 32K ROMs. The full size keyboard is gone and has a simple numeric keypad instead. Since the hardware chips are mapped to different areas in the 5200, standard 400/800 software is incompatible but 5200 games *can* be converted to run on the 400/800 with some programming know-how.
  241.  
  242. The monitor ROM is a tiny 2K OS which just sets up the 5200 for operation and draws the pretty rainbow fuji logo. You can insert either 16K or 32K 5200 ROM images in this mode. Once again, 400/800/800XL/130XE games will *not* work with the 5200 and vice versa.
  243.  
  244. The 5200 # and * keys are at Z and X. The top fire button is SHIFT, the lower fire is CTRL.
  245.  
  246. See 'Appendices' text file for more on the 5200 and how to get the 2K ROM.
  247.  
  248.  
  249.  
  250. Registration
  251. ------------
  252.  
  253. To register and get the full-feature packed version, check out the 'Registration' text file or see the website URL below!
  254.  
  255.  
  256.  
  257. This demo may be copied and freely circulated. However, all the files must be included and they must not be modified in any way.
  258.  
  259.  
  260.  
  261. ----------------------------------------------------------------------------------
  262.  
  263. Comments and suggestions to...
  264.  
  265. E-mail: jx91@cityscape.co.uk
  266. WWW   : http://www.cityscape.co.uk/users/jx91/emulators.html
  267.  
  268. Rainbow (c) 1995-6 by Chris Lam.
  269.  
  270. ----------------------------------------------------------------------------------
  271.